home *** CD-ROM | disk | FTP | other *** search
/ MacUser Mac Bin 40 / MACUSER-MACBIN40A-1997-03.ISO.7z / MACUSER-MACBIN40A-1997-03.ISO / 特集⁄オンラインソフト / ゲーム＆アミューズメント / アミューズメント / Citron 1.07J⁄E / 収録XCMD説明＆サンプルスタック / XCMD⁄XFCN説明書 / vanilla説明書 < prev   
Text File  |  1996-08-26  |  9KB  |  174 lines
  1. 　Vanilla XCMDは、スタックを利用する際、スタックウインドウの背後に表示されているファインダー画面などのスタック利用に不必要なものを隠すためのXCMDです。
  2. 　背景が表示されていると不都合があるプレゼンテーションや、業務システムその他等で他のアプリケーションに移ると不都合な場合など、各種スタックに有効なものと思われます。
  3. 　Vanilla XCMDは、落合　徹（ちゃい）が著作権を所有しています。自作のスタックなどに利用する場合は、当ドキュメントの「使用上の注意」の項を良く読んでからご使用ください。
  4. 　なお、自作のスタック等にインストールする場合は、CitronをHomeスタックへインストールするか、ResEdit等のリソース関連ツールでVanilla XCMDをコピーしてください。
  5.  
  6. 【Vanilla XCMD】（Version 1.42      CodeWarrior Gold9使用 1996/6）
  7.  
  8. 0．更新履歴
  9. （Version 1.42      CodeWarrior Gold9使用 1996/6）
  10.   Power Macintoshネイティブのバージョンも新たに作成
  11.   Citron添付用に、名称を今までのHideBackからVanillaに変更
  12.  
  13. （Version 1.40      THINK C 5.0.4使用 1993/9作成）
  14. 　デスクトップパターンを使用できる様にした
  15. 　PICT形式のファイル／リソース／クリップボードデータを使用できるようにした
  16. 　'ppat'リソースを利用できるようにした
  17.  
  18. （Version 1.00      THINK C 5.0.4使用 1993/8作成）
  19. 　初回バージョン
  20.  
  21. 1．使い方
  22.  
  23. 以下に使い方を紹介します。
  24.  
  25. ・不用な部分を隠蔽する方法
  26.  
  27.   Vanilla true,隠蔽方法指定子
  28.   Vanilla スタックウインドウ名,隠蔽方法指定子
  29. もしくは
  30.   Vanilla on,隠蔽方法指定子
  31.  
  32. 　これでスタックのウインドウより後ろが隠れるはずです（HyperCardのパレットは残ります）。
  33. 　スタックのウインドウ名を指定した場合は、指定した名称のスタックの後ろが隠れます。複数スタックを開いている時は、一番後ろのスタックの名前を渡して下さい。
  34. 　存在しないスタックのウインドウ名を渡した場合は一番上のスタック（カレントスタック）名を用います。
  35.  
  36. 　隠蔽方法指定子は以下のものを指定できます。
  37. 　（スクリプトフォーマットの'{}'はその括弧内の一つを選ぶ。'[]'は省略可能を示す）
  38.  
  39. ・カラー
  40.  
  41. 　Vanilla {ture/on/スタック名},赤 [緑,青]
  42.  
  43. 　任意の色を指定できます。
  44. 　赤, 緑,青を数字で指定します。
  45. 　赤、緑、青の所にはそれぞれ０〜65535の値を入れます。
  46. 　それぞれに０を入れれば背景は黒に、65535を入れれば白になります。
  47. 　この際、赤だけ指定すれば、自動的に緑と青に赤と同じ値が採用されます。
  48.  
  49. 　例）背景を黒にしたい場合
  50.     Vanilla true,0
  51.     Vanilla true,0,0,0
  52. 　（どちらでも同じ結果になります）
  53.  
  54. ・PICT画像（ファイル指定）
  55.  
  56. 　Vanilla {ture/on/スタック名},file,PICTファイル格納パス [,dither]
  57.  
  58. 　ユーザーが用意した任意のPICTファイルを指定できます。
  59. 　画像の大きさが全画面より小さい場合は、繰り返して（タイル状に）表示されます。
  60. 　ditherオプションをつけると、PICTデータがディザー可能な場合は、フルカラー画面でなくてもディザリング処理を施した疑似フルカラー表示が可能です（但し、スピードが低下します）。
  61.  
  62. ・PICT画像（リソース）
  63.  
  64. 　Vanilla {ture/on/スタック名},resource,PICTリソースID [,dither]
  65.  
  66. 　ユーザーがスタックにあらかじめインストールしておいた任意のPICTリソースを指定できます。
  67. 　画像の大きさが全画面より小さい場合は、繰り返して（タイル状に）表示されます。
  68. 　ditherオプションをつけると、PICTデータがディザー可能な場合は、フルカラー画面でなくてもディザリング処理を施した疑似フルカラー表示が可能です（但し、スピードが低下します）。
  69.  
  70. ・PICT画像（クリップボード）
  71.  
  72. 　Vanilla {ture/on/スタック名},clip [,dither]
  73.  
  74. 　クリップボードに格納されているPICT画像を指定できます。
  75. 　画像の大きさが全画面より小さい場合は、繰り返して（タイル状に）表示されます。
  76. 　ditherオプションをつけると、PICTデータがディザー可能な場合は、フルカラー画面でなくてもディザリング処理を施した疑似フルカラー表示が可能です（但し、スピードが低下します）。
  77.  
  78. ・デスクトップパターン
  79.  
  80. 　Vanilla {ture/on/スタック名},desktop
  81.  
  82. 　デスクトップに使用されているパターンを使用します（Systemファイルの'ppat'リソースID=16）。
  83.  
  84. ・カラーパターン('ppat'リソース)
  85.  
  86. 　Vanilla {ture/on/スタック名},ppat,'ppat'リソースID
  87.  
  88. 　ユーザーがスタックにあらかじめインストールしておいた任意の'ppat'リソースを指定できます。
  89. 　指定の'ppat'リソースが見つからない場合は'PAT 'リソースを使用します。
  90. 　指定したIDのリソースが見つからない場合は、エラーを返さずに、灰色のパターンが作成されます。
  91.  
  92. 　それぞれの例は、サンプルスタックの各ボタン内のスクリプトを参考にして下さい。
  93. 　第一パラメーターにonを使用したときは、背景部分をクリックするとビープ音が鳴るようになります。
  94.  
  95. ・XCMDを終了する方法
  96.  
  97.   Vanilla off
  98.  
  99. 　とするだけです。外部ウインドウが消去され、隠蔽していた部分が表示されます。
  100.  
  101.  
  102. 　隠蔽指定、終了のどちらの場合も、以下のエラーが返される可能性があります。
  103.  
  104. 　Error:Missing parameters（コマンド、パラメーターが一つも指定されていない）
  105. 　Error:Vanilla not available（Vanilla XCMDは現在使用されていない）
  106. 　Error:Syntax invalid（文法エラー）
  107. 　Error:Empty file name was given（ファイルパスが与えられていない）
  108. 　Error:Can't open file（ファイルがオープンできなかった）
  109. 　Error:Access trouble on file（ファイル構造に誤りがある。PICTファイルではない）
  110. 　Error:Empty resource ID was given（リソースIDが与えられなかった）
  111. 　Error:Can't find PICT from clipboard（クリップボードにPICTデータが無かった）
  112. 　Error:Syntax error（文法エラー）
  113. 　Error:Couldn't allocate storage for window variables（メモリーが確保できなかった）
  114. 　Error:Couldn't create XWindow（外部ウインドウが作成できなかった）
  115.  
  116. 　XCMD内ではHideBackScreenという名前の外部ウインドウを作成しています。この名称を持ったPICTファイル等をPictureコマンド等で表示しないようにしてください。
  117.  
  118. 2．XCMDバージョン
  119.  
  120. 　以下の方法で、Vanillaのバージョンを調べることができます。
  121.  
  122. 　　Vanilla XCMDVersion
  123.  
  124. 　the resultによって以下の書式のメッセージが取り出せます。
  125.  
  126. 　　Vanilla XCMD Version *.** by -Chai-
  127. 　　Vanilla XCMD PPCVersion *.** by -Chai-　　　（Power Macintoshバージョンの場合）
  128.  
  129. 　４ワード目に必ずバージョンナンバー（*.**の部分）が格納されているので、チェックする場合はそれを対象にしてください。
  130.  
  131. 3．Vanillaの使用上の注意
  132.  
  133.  HideBack XCMD 1994 (C) Copyright ちゃい=Chai=
  134.  Vanilla XCMD 1996 (C) Copyright 落合　徹（ちゃい）
  135.  
  136.   当パッケージを使用してトラブルが起こった際に、本項を読んでいないといった理由は一切受け付けることはできません。内容主旨を理解したうえでご使用ください。
  137.  
  138.   再配付を行なう様な場合は許可を取ってください（店頭での配付や、他ネットでの配付も含む。有料・無料どちらの場合もお願いします）。
  139.   個人的使用、およびそれに準ずる範囲内を越えた利用の際は、次項の注意をよく理解した上で使用してください。
  140.  
  141.   当パッケージを使ったことによって生じた直接、間接の損害については、権利者および配付者は一切の責を負わないこととします。あくまで使用者の責任の範囲で運用を行なってください。
  142.  
  143. 4．XCMD/XFCNの使用上の注意
  144.  
  145. 　当XCMD/XFCNの著作権その他の権利は落合　徹（ちゃい）が所有しています。無断で外部使用することを禁じます。この項の説明はstart usingなどで間接的にXCMD/XFCNを使用する場合（Citronでの利用）も、同じ扱いとします。
  146.  
  147. 　Citronの登録ユーザーの方は、個人的使用、およびそれに準ずる範囲内で、自由にご使用ください。
  148. 　PDSその他等で配付する場合は以下の通りとなります。いずれの場合も、配布者はCitronの登録ユーザーである必要があります。
  149.  
  150.   ･フリーウエアに収録して配付の場合は、原則的に無料で許可を出します。
  151.   ･シェアウエアもしくはそれに準ずる形式の配付の場合は（あるいはフリーウエアでも有償にて配付する場合）、XCMD使用料(配付ソフト一種につき￥５０００)をいただきます。
  152.   ･業務目的で使用する場合、利益を生む配付（市販も含む）を行なう場合は別途ご相談ください。XCMD使用料およびライセンス料をいただきます。
  153.  ・収録せずに利用する場合、すなわちstart using等でCitronに収録されたXCMD/XFCNを呼び出す場合は、上３項目に該当しません（つまり、無料ですし、連絡の必要もありません。Citronの登録ユーザーである必要はあります）。ただし、当然ながらXCMD/XFCNを使用するソフト（配布ソフト）のユーザーがCitronの登録ユーザーである必要があります。
  154.  ・当XCMD/XFCNを収録したフリーウエア／シェアウエア（もしくはこれらに準ずる形式の配布形態）を雑誌等の媒体にて配布する場合、シェアウエアもしくはそれに準ずる形式の配付とみなして、配布ソフト作成者あるいは配布者（雑誌等の媒体）より、XCMD使用料(配付ソフト一種につき￥５０００)をいただきます。ただし、シェアウエアもしくはそれに準ずる形式の配付として既にXCMD使用料をいただいている場合は、二重に支払う必要はありません。
  155.  
  156. 　連絡を取る場合は、２日〜１ヵ月の余裕をみておいてください。
  157. 　無断使用が発覚した場合、賠償請求させていただくことがあります。
  158.  
  159. 　どの場合もドキュメント等に、以下の項目を記載してください。
  160. 　文章スタイル等は変更なさってもかまいません。
  161.  
  162. ・Vanilla XCMDの著作権その他の権利は落合　徹（ちゃい）（Nifty:QGA01617）が所有しています。
  163. ・Vanilla XCMDを自作スタック等に使用なさりたい場合は、Nifty-Serve FMACHYPよりCitronスタックを入手し、登録した上でご利用ください。
  164. ・Vanilla XCMDを使ったことによって生じた直接、間接の損害については、XCMD作者および配付者は一切の責を負わないこととします。あくまで使用者の責任の範囲で運用を行なってください。
  165. ・無断使用が発覚した場合、賠償請求させていただくことがあります。
  166.  
  167. 動作チェック環境
  168.   漢字Talk 7.5.1,7.5.2
  169.   HyperCard 2.3J
  170.   QuickTime 2.0J,2.1J
  171.   Power Macintosh 8100/80AV,Macintosh LC630,Power Macintosh PowerBook 5300cs
  172.  
  173. 　漢字Talk７以降なら、動作するものと思われます。
  174.